home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr39 / bpq406f.zip / COMMANDS.DOC < prev    next >
Text File  |  1992-08-05  |  16KB  |  405 lines
  1.         G8BPQ NODE COMMANDS
  2.  
  3.  
  4. This document explains the commands available within the Node section
  5. of the G8BPQ switch, and an explanation of the responses. 
  6.  
  7. First the result of inputting an invalid command:
  8.  
  9. NOTTS:G8BPQ-3} Invalid command - Enter ? for command list
  10.  
  11. Entering ? produces the following:
  12.  
  13. NOTTS:G8BPQ-3} BBS CONNECT BYE INFO NODES PORTS ROUTES USERS
  14.  
  15. Note that BBS is only present if the BBS support is enabled (BBS=1 in 
  16. th config file). If you have defined your own applications, they will also
  17. be listed.
  18.  
  19.  
  20. The BBS (and your other application names) must be entered in full - all other
  21. commands can be abbreviated to the first character of the command.
  22.  
  23.  
  24. Entering BBS (or your own application name) will connect you to the first
  25. free BBS (etc) port, or give an error message if none are available.
  26.  
  27.  
  28. The CONNECT command is used to connect you to another node, or to a normal
  29. AX.25 user. To connect to another node, enter C NODECALL or C NODEALIAS.
  30. The system will select the 'best' radio port and neighbour to to use to
  31. reach the required node using its ROUTES and NODES lists.
  32.  
  33. The format used to connect to another normal user depends on whether you
  34. have more than one radio port. The formats are:
  35.  
  36. (stuff in [] being optional)
  37.  
  38. C CALL [via digi1 [digi2...]]        If you only have one port
  39.  
  40.  
  41. C P CALL [via digi1 [digi2...]]         Where P is the port number,
  42.                     if you have more than 1.
  43.  
  44.  
  45. (You can use C 1 CALL if you only have 1 port - its just a waste of typing!)
  46.  
  47.  
  48. If you miss out the port number where it is needed, you will get an error
  49. message, listing the available ports.
  50.  
  51. Normally you cannot override the automatic route selection when you connect
  52. to another node, but you can fool the system into thinking a node is a
  53. normal station by connecting to the alias, and adding an SSID. For example,
  54. if you want to connect to NOTTS:G8BPQ-3, you can force a Level 2 connect
  55. on a secified port by entering C P NOTTS-1
  56.  
  57. It is also possible to instruct the node to remain connected to the
  58. currrent node, when the connection to the next one is closed. This is
  59. achieved by adding an S (for STAY) after the connect command. For
  60. example, if I type
  61.  
  62.     C GB7YDX S
  63.  
  64. I get
  65.  
  66. NOTTS:G8BPQ-3} Connected to GB7YDX
  67.  
  68. If I then enter B, GB7YDX closes the connection, but instead of getting
  69. *** Disconnected, I get
  70.  
  71. Returned to Node NOTTS:G8BPQ-3} 
  72.  
  73. This is particularly useful if you are exploring a distant set of nodes, 
  74. and don't want to have to reconnect over the whole path again and again.
  75.  
  76.  
  77.  
  78. The BYE commnad disconnects you from the switch.
  79.  
  80.  
  81.  
  82. The INFO command sends your INFO text from the config file:
  83.  
  84. NOTTS:G8BPQ-3} G8BPQ Packet Switch, Mapperley, Nottingham. IO92KX
  85. Commands are basically the same as NET/ROM, but to connect to another
  86. normal station (not another node), you must specify a port number before
  87. the callsign. Use PORTS command to list available ports. The BBS command
  88. connects you to the associated Mailbox.
  89.  
  90.  
  91.  
  92. The PORTS command lists available ports. The descriptions come directly
  93. from the configuration file, and should give at least the frequency and
  94. baud rate used.
  95.  
  96. NOTTS:G8BPQ-3} Ports:
  97.   1 144.650 MHz 1200 Baud (PC120)
  98.   2 432.675 MHz 1200 Baud (DRSI)
  99.   3 Experimental NET/ROM Link
  100.  
  101.  
  102.  
  103. The NODES command lists all the other NETROM/THENET/BPQ Nodes known to
  104. your node:
  105.  
  106. NOTTS:G8BPQ-3} Nodes:
  107. BBSTST:G8BPQ-1     DV7:G4RFG-1        LRG7:G0GDR-1       G4RFG-2
  108. LRGBBS:GB7LRG      AAABBS:GB7AAA      #LNX2:G4GOU-1      BM1:G7AXC-1
  109. BM2:G7AXC-2        BM7:G7AXC-7        DV2:G4RFG          DV6:G4RFG-3
  110. BOB432:G8HBE-3     NEC21:G8VPQ-2      FPV7:G4FPV-7       SY4:G3UQH-4
  111. WP4:G0KNR-4        LRG2:G0GDR-2       NEC22:G8VPQ-3      MM2:GB7MM-2
  112. TFONET:G8TFO-8     NEC90:G8VPQ-9      NH:G0HWC           RP2:GB3RP-2
  113. ADH2:G8ADH-2       SY7:GB7SY-7        HX2:GB7HX-2        WORC7:G8TIC-7
  114. WV2:G1RLI-2        TEWKS3:G6CMG-3     WB7:G4DVM-7        BOB650:G8HBE-2
  115. LED:GB7LED         SY8:G3UQH-8        VPQNET:G8VPQ-8     GH2:GB7GH-2
  116. SY2:G3UQH-2        FPV:G4FPV-2        AP2:GB7AP-2        LX2:GB7LX-2
  117. LX4:G6TNZ-1        LX7:GB7LX-7        RAYNET:GB7NRC      SF2:G8POT-2
  118. #NICK:GB7LRG-7     NEC72:G8VPQ-7      WORC2:G8TIC-2      PQ2:GB3PQ
  119. TEWKS4:G6CMG-4     BOB675:G8HBE-4     FPV71:G4FPV-8      TEWKS9:G6CMG-9
  120. TICNET:G8TIC-8     BRX:G4AKZ          SC4:G4AJJ-4        CD2:G6ANN-1
  121. TEWKS7:G6CMG-7     TCPIP:G4GOU        CHELT2:G4MEM-2     DROIT7:G8TFO-7
  122. DROIT2:G8TFO-2     MK6:G4WIM          MV2:G2AFD-2        SERVER:GB7AAA-9
  123. ERA24:G0DXX        WP1:GB7WP-1        WP2:GB7WP-2        WP7:GB7WP-7
  124. MK2:G4WIM-2        MK23:G4WIM-7       LNXBBS:GB7LNX-2    TVB:G6TVB
  125. #GATE0:G6CMG-5     #GATE1:G6CMG-6     WORC22:G8TIC-1     VPQ90:G8VPQ-10
  126. VPQ91:G8VPQ-11
  127.  
  128.  
  129. By entering N NODECALL (or N NODEALIAS), you can list the routes that
  130. the system will use to access that node:
  131.  
  132. n gb7ydx
  133.  
  134.  
  135. NOTTS:G8BPQ-3} Routes to: DXYORK:GB7YDX RTT=7 FR=17  B 2
  136. > 87 4 5 GB7YS
  137.   0 4 7 G8BPQ-8
  138.   0 4 6 G4FIS-2
  139.  
  140. The bits after the callsign are only shown if some frames have been 
  141. send to that node. RTT stands for Round Trip Time, and is a rolling
  142. average of the time taken to get a response from that node (in seconds).
  143. FR means Frames, the number of info frames sent to the node. The B, if
  144. present, indicates the target is a BPQ node, and the number following 
  145. the B is the number of hops to the target. 
  146.  
  147. Up to 3 possible routes to the node are listed. The first number
  148. displayed is the 'quality' - the relative desirability of using this
  149. route rather than another. The second is the Obsolesance Count, an
  150. indication of how long it is since the system was last told about (
  151. or successfully used) this route. The number starts at a value set in
  152. the config file (typically 5) and is decremented each time a 'NODES'
  153. broadcast is sent (typically evey hour). The 3rd number is the port.
  154. A > indicates the currently active route.
  155.  
  156. The Round Trip Times and frame counts for all nodes with a non-zero 
  157. count can be displayed by entering N T
  158.  
  159.  
  160. n t
  161. NOTTS:G8BPQ-3} Nodes:
  162. G1FYS              RTT=22 FR=5  B 
  163. #LDS:G3WNR-3       RTT=17 FR=39  B 
  164. AP21:GB7AP-2       RTT=90 FR=866
  165. AYTON:G4HRM        RTT=76 FR=18  B 
  166. BADBBS:GB7BAD      RTT=40 FR=2576  B 2
  167. BEDS:G1ZPU         RTT=283 FR=1  B 4
  168. BFD41:G4GIR-4      RTT=31 FR=593
  169. BOSTON:G4LPL       RTT=28 FR=1606  B 2
  170. COV22:G3ZFR-3      RTT=29 FR=14
  171. DXYORK:GB7YDX      RTT=7 FR=17  B 
  172. HALFAX:G6KZJ       RTT=30 FR=306  B 2
  173. HF:G4JLB-8         RTT=32 FR=99  B 4
  174. LADY61:G7EQM-8     RTT=68 FR=1754  B 1
  175. NEC:G8VPQ          RTT=113 FR=127  B 
  176. NN22:G8AMG-2       RTT=30 FR=2047
  177. NN41:G8AMG-4       RTT=19 FR=250
  178. NN72:G8AMG-7       RTT=19 FR=301
  179. NOTBBS:GB7NOT      RTT=34 FR=5659  B 1
  180. OAK:G0LTN-1        RTT=76 FR=1309  B 3
  181. PBORO:G1ARV-8      RTT=26 FR=230  B 2
  182. RP:GB7RP           RTT=41 FR=1396  B 
  183. RUTBBS:GB7RUT      RTT=10 FR=10683  B 1
  184. RUTLND:G4FIS-2     RTT=7 FR=16468  B 1
  185. SHEF:GB7YS         RTT=15 FR=11547  B 1
  186. TLH2:G1TLH-2       RTT=36 FR=5245  B 
  187. WN:G7HPM           RTT=52 FR=2281  B 4
  188. XOWPMS:G1XOW-2     RTT=38 FR=58  B 
  189. YORK:G1FTA         RTT=37 FR=363  B 3
  190. YORKS:GB7YW        RTT=20 FR=117  B 
  191.  
  192.  
  193.  
  194. The ROUTES command lists the stations which this node can hear. 
  195.  
  196. NOTTS:G8BPQ-3} Routes:
  197.                      
  198.   4 GB7YS 0 0! 
  199.   1 G4FIS-2 14 0! 
  200.   3 G3SDC-8 35 0! 
  201. > 6 G4FIS-2 150 58!  
  202.   3 G0INA-1 90 0!  
  203.   2 G8BPQ-5 250 0!
  204.   4 G1EQT-8 50 0!  
  205. > 4 G0INA-3 120 48!  
  206. > 5 GB7YS 150 93! 
  207.   3 G7JGX-3 25 0!  
  208. > 4 G4IRX-3 50 9! 
  209.   7 G8BPQ-8 250 105  
  210.   4 G7EQM-8 10 1  
  211.  
  212.  
  213.  
  214. The > indicates that there is an active link to the node.
  215. The first number is the port. The second is the quality. This may be
  216. derived from the 'default quality' parameter in the PORTS section of the
  217. config file, or may be specified explicitly in the ROUTES section.
  218. A value of zero will prevent the route from being used, and is normally
  219. used when you have a one-way or marginal path. The third number is the
  220. number of NODES list entries which refer to this route. This isn't used
  221. by the software - it is just information for the user. The '!' indicates
  222. a 'locked route' - one entered in the CONFIG file, or via SYSOPH. Other
  223. entries come and go as this node hears NODES broadcasts.
  224.  
  225.  
  226. Additional information may be obtained by entering r r
  227.  
  228. r r
  229. NOTTS:G8BPQ-3} Routes:
  230.   4 GB7YS 0 0!  8  0  0%  0  0  18:52
  231.   1 G4FIS-2 14 0!  0  0  *  0  0  00:00
  232.   3 G3SDC-8 35 0!  0  0  *  0  0  00:00
  233. > 6 G4FIS-2 150 58!  57022  1333  2%  0  0  21:55  0
  234.   3 G0INA-1 90 0!  0  0  *  0  0  00:00
  235.   2 G8BPQ-5 250 0!  0  0  *  0  0  00:00
  236.   4 G1EQT-8 50 0!  0  0  *  0  0  17:13
  237. > 4 G0INA-3 120 48!  19305  819  4%  0  0  21:40  0
  238. > 5 GB7YS 150 93!  27017  6229  23%  0  0  21:44  0
  239.   3 G7JGX-3 25 0!  0  0  *  0  0  00:00
  240. > 4 G4IRX-3 50 9!  2025  42  2%  0  0  22:09  0
  241.   7 G8BPQ-8 250 105  592  0  0%  0  0  22:02
  242.   4 G7EQM-8 10 1  3077  219  7%  0  0  21:37
  243.  
  244.  
  245. The extra fields are:
  246.  
  247.    Info frames sent
  248.    Info frames retransmitted
  249.    Retry Rate - the ratio of the above 2, as a percentage
  250.       (or * if both are zero)
  251.    Non-standard maxframe (from Config file)
  252.    Non-standard frack    (      ditto     )
  253.    Time the last NODES broadcast was heard from this node.
  254.  
  255.    The last figure is only present if there is an active link. It
  256.    is the number of frames queued to be sent. Up to 4.05e, this only
  257.    counts frames queued above the link level - there may be up to 
  258.    another 8 queued at link level. With version 4.05f and above it
  259.    includes all frames queued. 
  260.  
  261.  
  262. The retry rate gives a good indication of how well the link is running. 
  263. Dedicated links should normally be well below 10%. A shared link 
  264. will normally have a higher rate, but anything above say 25% is likely
  265. to cause significant delays. Another indication of a poor link is a
  266. high number of frames queued - any nonzero value of 4.05e or below, or
  267. above 8 for later versions which persists for more that a minute or so
  268. is likely to be causing problems.
  269.  
  270.  
  271.  
  272.  
  273. The USERS command lists the stations currently using the node.
  274.  
  275.  
  276. NOTTS:G8BPQ-3} G8BPQ Network System V3.21 (95)
  277. Host6(NOTTS:G8BPQ-3)
  278. Host3(NOTTS:G8BPQ-3)              <-->  Circuit(LRG7:G0GDR-1 G8BPQ-1)
  279. Uplink(G9XXX)                     <~~>  Downlink(G9YYY)        
  280.  
  281.  
  282. Host is an internal (Normally BBS Port)
  283. Circuit is a link from/to another node.
  284. Uplink is a connection from a normal Ax.25 station.
  285. Downlink is a connection to a normal user.
  286.  
  287. The <--> indicates an active session. <~~> indicates a session being set up.
  288.  
  289. The Number on the end of the header line is the number of free buffers.
  290.  
  291.  
  292.  
  293. There are a few commands not given in the menu. These are primarily of 
  294. interest to the sysop, (or for me to experiment with). They are LINKS,
  295. STATS, L4T1, and PACLEN.
  296.  
  297.  
  298. The LINKS command lists the currently active AX.25 Sessions (Both user
  299. access and node-node links)
  300.  
  301. NOTTS:G8BPQ-3} Links:
  302. G0GDR-1 G8BPQ-3 S=5 P=2 T=3 V=2
  303.  
  304. S is the link state (see AX25 protocol spec, but the main ones are 
  305.   2 (connecting) 4 (disconnecting) 5 (connected)).
  306. P is the port.
  307. T is the link type. 1=Uplink, 2=Downlink, 3=Node-Node link.
  308. V is the AX.25 Version (1 or 2).
  309.  
  310.  
  311.  
  312. The STATS command displays a number of counters.
  313.  
  314. s
  315. NOTTS:G8BPQ-3} 
  316. Time active (mins)               8786
  317. Timer Overruns                     48
  318. Buffers: Max/Cur/Min/Out          100       76       16        0
  319. Known Nodes                       144
  320. L4 Connects Sent/Rxed            1055     1732
  321. L4 Frames TX/RX/Resent/Reseq    73288    96544     1870       42
  322. L3 Frames Relayed               10148
  323.  
  324. L2 Frames Digi-ed       0        0        0        0        0        0        0
  325. L2 Frames Heard    124393     1870    80601    82124    60600   167575     2650
  326. L2 Frames Rxed      11921        0     2909    66674    59032    94340     1447
  327. L2 Frames Sent      15955     1870     4690    69857    71328   107267     3284
  328. L2 Timeouts          4466        0      984     5437     7697     1154       58
  329. REJ Frames Rxed         7        0        2      460     1681      214        0
  330. RX out of Seq         269        0        3      951     1697      272        0
  331. Underrun/Poll T-O       0        0     5358      233        0        0        0
  332. RX Overruns             0        0    39814        0        0        0       63
  333. RX CRC Errors       42260        0        1        0     2324    27025        0
  334. FRMRs Sent              0        0        0       19        0        0        0
  335. FRMRs Received          0        0        0        0        0        0        0
  336. Frames abandoned        1        0        0        0        0        2        0
  337. Link Active %       9  64    0   0    0   0    0   0   14  21   50  82    0   0
  338.  
  339.  
  340. Most are fairly obvious, but a few need a bit of explanation. There is one
  341. set of level 2 counters for each port.
  342.  
  343.  
  344. Time Active is the time since the system was loaded.
  345.  
  346. The Buffer count Maximum, Minimum and Current should be obvious. The
  347. Out figure is the number of times a request to allocate a buffer 
  348. failed because there were none available.
  349.  
  350. The L4 frames resent count is the number retransmitted because an 
  351. ACK wasnt received within the L4 timeout period. The Reseq count
  352. is the number of frames received out of sequence, but subsequently
  353. used because the missing frame(s) eventually arrived.
  354.  
  355. Timer Overruns count the number of times the main code (which is initiated
  356. by the timer interrupt) is still running when the next timer interrupt
  357. occured. If it increments very rapidly (several times a minute), it 
  358. indicates that the PC is too slow for the amount of data being processed.
  359. It is normal for an XT class machine running a couple of BBS ports to get
  360. about one overrun per minute. My 10MHz AT clone shows very few.
  361.  
  362.  
  363. A large number in the 'REJ received' field may indicate that your Maxframe
  364. is too high. Similarly a large number in 'RX out of sequence' may indicate
  365. the the station taking to you has too large a maxframe. 
  366.  
  367. RX Overruns indicate characters lost because the software didn't process 
  368. the interrupts fast enough. If you are running KISS ports, and you get
  369. a lot (ie a significant percentage of L2 frames heard), try reducing the
  370. speed of the link from the PC to the TNC. If you are using an HDLC card
  371. (DRSI or PC120), particularly at high speed, then there isnt much you 
  372. can do except buy a faster machine. (But I would like to hear from anyone
  373. having problems running at 9600 baud or above - I may be able to speed up
  374. the routines a bit).
  375.  
  376. Underuns indicate a similar problem in responding to TX interrupts,
  377. but only apply to HDLC cards. As you cant get a TX underrun on an
  378. async port, this field is also used to count timeouts on a polled KISS
  379. system).
  380.  
  381. Frames abandoned counts the number of frames discarded because they have
  382. been waiting to be sent (for DCD to clear) for more than 60 secs. If a
  383. lot occur, then either your squelch is a bit dodgy, or the channel is 
  384. VERY busy. Only used for HDLC cards.
  385.  
  386. Link Active shows two values for each port. The first is the % of time
  387. in the last minute that your station was transmitting, and the second
  388. the % the channel was active (sum of Transmitting and DCD active). Only
  389. maintained for HDLC ports. Note that of you are using SOFTDCD, then the
  390. indicated % active may be an overestimate.
  391.  
  392.  
  393.  
  394. The L4T1 command displays or sets the Level 4 timeout used for the current
  395. session. It is primarily for me to experiment with.
  396.  
  397.  
  398. PACLEN sets or displays the PACLEN value used for messages generated by
  399. the node (eg command responses). Again it is mainly for me to play with.
  400.  
  401.  
  402.  
  403. John Wiseman, G8BPQ
  404. Revised 5/8/92
  405.